tests: Add unit tests for fileUtils module

The module is perfectly self-contained, which makes it easy to
test. We should do so.

Part-of: <https://gitlab.gnome.org/GNOME/gnome-shell/-/merge_requests/3721>

diff --git a/tests/meson.build b/tests/meson.build
index a75fa6b46ea1db0fe76268c0b297f37356c37e61..6882e44bce7b06316945477441b727c4322f626a 100644 (file)
--- a/tests/meson.build
+++ b/tests/meson.build
@@ -22,6 +22,12 @@ unit_testenv.append('GI_TYPELIB_PATH', st_typelib_path, separator: ':')
 unit_tests = {
   'breakManager': {},
   'extensionUtils': {},
+  'fileUtils': {
+    'env': {
+      'XDG_DATA_DIRS': join_paths(meson.current_source_dir(), 'unit/fixtures/datadirs/system'),
+      'XDG_DATA_HOME': join_paths(meson.current_source_dir(), 'unit/fixtures/datadirs/home'),
+    },
+  },
   'highlighter': {},
   'injectionManager': {},
   'insertSorted': {},

diff --git a/tests/unit/fileUtils.js b/tests/unit/fileUtils.js
new file mode 100644 (file)
index 0000000..47d8814
--- /dev/null
+++ b/tests/unit/fileUtils.js
@@ -0,0 +1,126 @@
+import GLib from 'gi://GLib';
+import Gio from 'gi://Gio';
+
+import * as FileUtils from 'resource:///org/gnome/shell/misc/fileUtils.js';
+
+const SUBDIR = 'collect-datadirs';
+
+describe('collectFromDatadirs()', () => {
+    const {collectFromDatadirs} = FileUtils;
+
+    it('can collect files from all datadirs', () => {
+        const files = [...collectFromDatadirs(SUBDIR, true)];
+        expect(files.length).toEqual(2);
+    });
+
+    it('can collect files from only system datadirs', () => {
+        const files = [...collectFromDatadirs(SUBDIR, false)];
+        expect(files.length).toEqual(1);
+    });
+
+    it('returns objects with file and info properties', () => {
+        const [{file, info}] = collectFromDatadirs(SUBDIR, false);
+        expect(file instanceof Gio.File).toBeTrue();
+        expect(info instanceof Gio.FileInfo).toBeTrue();
+    });
+
+    it('returns user files before system files', () => {
+        const dataHome = GLib.get_user_data_dir();
+        const [{file: first}, {file: last}] = collectFromDatadirs(SUBDIR, true);
+        expect(first.get_path().startsWith(dataHome)).toBeTrue();
+        expect(last.get_path().startsWith(dataHome)).toBeFalse();
+    });
+
+    it('returns file infos with standard::name and standard::type attributes', () => {
+        const [{info}] = collectFromDatadirs(SUBDIR, false);
+
+        expect(info.has_attribute('standard::name')).toBeTrue();
+        expect(info.has_attribute('standard::type')).toBeTrue();
+    });
+});
+
+function touchFile(parent, name) {
+    const child = parent.get_child(name);
+    const stream = child.create(Gio.FileCreateFlags.NONE, null);
+    stream.close(null);
+}
+
+describe('recursivelyDeleteDir()', () => {
+    const {recursivelyDeleteDir} = FileUtils;
+    let dir;
+
+    beforeEach(() => {
+        dir = Gio.File.new_for_path(
+            GLib.dir_make_tmp('gnome-shell.unit-fileUtils.XXXXXX'));
+    });
+
+    it('deletes the contents of a dir', () => {
+        touchFile(dir, 'file');
+
+        expect(() => recursivelyDeleteDir(dir, false)).not.toThrow();
+        expect(dir.query_exists(null)).toBeTrue();
+        dir.delete(null);
+    });
+
+    it('optionally deletes the dir itself', () => {
+        touchFile(dir, 'file');
+
+        expect(() => recursivelyDeleteDir(dir, true)).not.toThrow();
+        expect(dir.query_exists(null)).toBeFalse();
+    });
+
+    it('recursively deletes subdirs', () => {
+        const subdir = dir.get_child('subdir');
+        subdir.make_directory(null);
+        touchFile(subdir, 'file');
+
+        expect(() => recursivelyDeleteDir(dir, true)).not.toThrow();
+        expect(dir.query_exists(null)).toBeFalse();
+    });
+});
+
+describe('recursivelyMoveDir()', () => {
+    const {recursivelyDeleteDir, recursivelyMoveDir} = FileUtils;
+    let srcDir, dstDir;
+
+    beforeEach(() => {
+        srcDir = Gio.File.new_for_path(
+            GLib.dir_make_tmp('gnome-shell.unit-fileUtils.XXXXXX'));
+        dstDir = Gio.File.new_for_path(
+            GLib.dir_make_tmp('gnome-shell.unit-fileUtils.XXXXXX'));
+    });
+
+    afterEach(() => {
+        recursivelyDeleteDir(dstDir, true);
+        recursivelyDeleteDir(srcDir, true);
+    });
+
+    it('moves the contents of a dir', () => {
+        touchFile(srcDir, 'file');
+
+        expect(() => recursivelyMoveDir(srcDir, dstDir)).not.toThrow();
+        expect(dstDir.query_exists(null)).toBeTrue();
+        expect(dstDir.get_child('file').query_exists(null)).toBeTrue();
+    });
+
+    it('creates the destination dir if necessary', () => {
+        dstDir.delete(null);
+
+        expect(dstDir.query_exists(null)).toBeFalse();
+        expect(() => recursivelyMoveDir(srcDir, dstDir)).not.toThrow();
+        expect(dstDir.query_exists(null)).toBeTrue();
+    });
+
+    it('recursively moves subdirs', () => {
+        const subdir = srcDir.get_child('subdir');
+        subdir.make_directory(null);
+        touchFile(subdir, 'file');
+
+        expect(() => recursivelyMoveDir(srcDir, dstDir)).not.toThrow();
+        expect(dstDir.query_exists(null)).toBeTrue();
+
+        const dstSubdir = dstDir.get_child('subdir');
+        expect(dstSubdir.query_exists(null)).toBeTrue();
+        expect(dstSubdir.get_child('file').query_exists(null)).toBeTrue();
+    });
+});

diff --git a/tests/unit/fixtures/datadirs/home/gnome-shell/collect-datadirs/file b/tests/unit/fixtures/datadirs/home/gnome-shell/collect-datadirs/file
new file mode 100644 (file)
index 0000000..e69de29

diff --git a/tests/unit/fixtures/datadirs/system/gnome-shell/collect-datadirs/file b/tests/unit/fixtures/datadirs/system/gnome-shell/collect-datadirs/file
new file mode 100644 (file)
index 0000000..e69de29